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ABSTRACT 


VIC  Input  Preprocessor  (VIP)  was  conceived  as  a  necessity  to  reduce  the 
time  required  to  develop  scenarios  for  the  combat  model.  Vector- In-Commander 
(VIC).  As  such,  VIP  works  primarily  with  the  second  and  third  largest  of  the 
VIC  Input  files:  the  global  ground  module  (.66),  of  which  VIP  provides  all  the 
unit  data,  and  the  ground  maneuver  module  (.6M),  of  which  VIP  provides  the 
tactical  area  data. 

In  addition,  the  following  modules  receive  at  least  part  of  their  input 
from  a  VIP-generated  output  file.  The  logistic  module  (.LO)  receives  the 
node  network  Information  from  VIP.  The  minefield  module  (.MF)  receives  the 
minefield  location  and  density  from  VIP.  The  terrain  and  barriers  module  (.TB) 
receives  the  barrier  Information  from  VIP. 

Another  major  function  of  VIP  is  the  ability  to  create  and  alter  maps 
as  per  user  specifications.  Map  coordinates  as  well  as  map  scale  are 
entirely  user  defined.  There  exist  separate  files  which  contain  not  only 
all  major  and  minor  roads,  but  also  rivers,  streams,  and  railways  which  are 
also  user  selectable. 

VIP  Is  a  graphics-based  software  package  which  contains  a  wide  variety 
of  routines  to  create  a  flexible  user  environment.  User  menus  can  be  moved, 
redefined,  and  redrawn  with  no  loss  In  operating  procedures.  Personal  color 
schemes  can  be  created,  changed,  and  saved  at  any  point  during  VIP  execution. 
The  package  also  contains  many  routines  for  the  creation  of  slides,  either 
text  slides  or  graphic  slides.  In  many  ways,  VIP  Is  a  generic  menu-driven 
graphics  package  which  does  not  have  to  be  exclusively  bound  to  VIC. 


1.  Purpose.  This  manual  provides  detailed  Information  on  all  options  and 
menus  pertaining  to  the  VIP  software  package.  It  also  shows  the  required 
logical  assignments  necessary  to  execute  the  VIP  software  package. 

2.  Scope.  This  manual  Is  designed  to  be  an  aid  for  use  In  conjunction  with 
the  Vip  Users  Manual.  This  manual  provides  the  range  of  valid  Inputs  or 
expected  character  string  Inputs. 

3.  VIP  menu  reference. 

a.  Main  menu.  The  main  menu  consists  of  a  series  of  data  menus  and 
several  user  features.  You  must  return  to  the  main  menu  to  end  the  program  or 
to  use  the  keyword  and  parameter  options,  as  this  Is  the  only  place  that  they 
appear.  Additionally,  the  main  menu  allows  access  to  the  data  menus  (any  menu 
In  which  a  file  Is  created,  I.e.,  unit  menu,  minefield  menu,  barrier  menu,  or 
network  menu.) 

Data  are  retained  until  a  menu  of  a  different  data  type  Is  selected,  or  the 
data  are  transferred  to  the  background  plane. 

If  there  are  entitles  (or  data)  currently  In  memory  when  this  menu  Is  selected, 
the  computer  prompts:  "HAS  DATA  BEEN  RECORDED?" 

Answer  -  YES  to  continue  (DESTROYS  EXISTING  DATA  IN  ARRAYS!) 

-  NO  returns  to  data  menu  to  record. 

No  other  action  Is  possible  until  this  question  has  been  answered. 

Main  menu  options: 

KEYWORD  **See  paragraph  3b  for  more  Information.** 

Transfers  control  to  CRT.  The  menus  are  cleared  from  the 
screen.  Keywords  are  then  input  from  the  CRT  until  the 
keyword  "MENU"  is  input.  It  is  through  this  function  that 
picture  files  can  be  created  along  with  slides. 

Individual  menus  can  be  moved  or  redefined  by  using  the 
proper  keywords.  The  setcolors  command  to  change  colors 
In  a  plane  is  reached  through  the  keyword  option. 

END  Exit  from  program.  All  files  are  closed. 

UNIT  MENU  **See  paragragh  3c  for  more  information.** 

Menu  for  defining  unit  locations  and  unit  data.  Allows 
access  to  the  path  points  menu  and  the  tactical  menu. 

These  menus  create  the  data  file  DA_DATA:UNIT#.DAT  which 
is  then  used  In  the  creation  of  the  VIC  global  ground 
module.  (.GG) 

UNIT  ID  GEN  **See  paragraph  3f  for  more  information.** 

Unit  identification  generator  for  name,  location, 
hierarchy,  and  symbol.  The  data  are  recorded  on  exit 
from  the  Id  generator  in  DA_DATA:UNIT#.DAT  and  control 
Is  returned  to  the  unit  menu. 


SUBORD  MENU  **See  paragraph  3g  for  more  Information.** 

Unit  subordinate  structure  menu  for  VIC  ground  maneuver 
module  (.GM)  Uses  as  Input  the  file  DA_DATA : UN IT# . DAT 
but  when  recording.  It  saves  Its  data  to  the  file  DA  DATA: 
UNIT#. SUB. 

COMMS  MENU  **See  paragraph  3h  for  more  Information.** 

Communications  structure  menu  for  creation  and  definition 
of  networks.  Uses  as  Input  the  file  DA  DATAtUNITf.DAT, 
but  when  recording.  It  Is  saved  to  DA_DTrA:UNIT#.NET. 

RT  PLAN  MENU  **See  paragraph  31  for  more  Information.** 

Detailed  route  planning  menu.  Not  designed  for  use  In 
the  creation  of  VIC  data  files  but  useful  In  the  area 
of  scenario  generation. 

MINEFLD  MENU  **See  paragraph  3j  for  more  Information.** 

Minefield  emplacement  menu  for  minefield  module  ( .MF) 

BARRIER  MENU  **See  paragraph  3k  for  more  Information.** 

Barrier  menu  for  area  obstacles  for  terrain  and 
barriers  module  (.TB) 

LINE  OB  MENU  **See  paragraph  31  for  more  Information.** 

Line  obstacle  menu  for  terrain  and  barriers  module  (.TB) 

NETWORK  MENU  **See  paragraph  3m  for  more  Information.** 

General  network  menu  for  logistics  module  (.LO)  The 
logistics  menu  Is  reached  from  this  menu.  It  works  on  the 
same  data  that  are  created  In  the  network  menu. 

PARAMETERS  **See  paragraph  3p  for  more  information.** 

Menu  to  set  parameter  switches.  The  UTM/MC  coordinate 
option  selection  resides  here.  The  major  function  of 
this  menu  is  to  allow  previously  defined  data  files  to 
be  read  In  when  the  user  Is  In  a  different  data  menu. 

CHANGE  PLANE  Transfer  entitles  from  foreground  to  background  planes. 

Background  plane  in  this  case  Is  defined  as  plane  2. 

The  data  will  be  visible  In  plane  2  but  can  no  longer 
be  worked  on. 

GRAPHICS  **See  paragraph  3q  for  more  Information.** 

Graphics  menu  to  load,  zoom  maps.  Also,  used  for  the 
clearing  of  the  upper  2  planes  and  setting  drawing  color. 

PLAYBACK  Play  back  the  detailed  route  planning  data  over  time. 

For  use  with  the  route  planning  files. 

UTILITY  MENU  Draw  the  utility  menu  which  contains  the  most  commonly 
used  keywords.  Unlike  the  keyword  option,  commands  are 
selected  with  the  cursor. 


b.  Keyword.  It  may  be  necessary  or  useful  to  enter  the  commands  via  the 
keyboard  and  not  with  the  bitpad.  A  complete  listing  of  keywords  is  given 
below. 


Keywords : 


—GRAPHICS - 

-TERRAIN - 

—MENU  MENU - 

-MENU  DEFINE— 

-SLIDE - 

-OTHER- 

ERASE 

SETC00R0 

SELECTMENU 

STARTX 

SELCOLOR 

HELP 

ERASE1 

MAPSIZE 

ORAWMENU 

STARTY 

SELPLANE 

DCL  CMD 

ERASE2 

SETFEATURE 

ERASEMENU 

ITXLNG 

SELTEXTSIZE 

DEMOLOAD 

ERASE3 

DRAMGRID 

SAVEMENU 

ITXSZ 

SELTEXTDIR 

UNITID 

SELERASE 

DRAWBORDER 

LOADMENU 

NUMBRX 

LINEDRAW 

END 

MAPERASE 

DRAWROADS 

MSAVEMENU 

NUMBRY 

TEXTDRAW 

SAVEPIC 

DRAMVEG 

MLOADMENU 

IGRPLN 

RECTDRAW 

LOADPIC 

DRAWCITY 

DEFINEMENU 

IGRCOL 

REMOVE 

SP  LOADPIC 

DRAHFADS 

SHOWMENU 

ICHPLN 

MOVEPIC 

MAKEPIC 

WHERE 

GRIDMENU 

ICHCOL 

EMOVEPIC 

PICTURE 

WHEREMC 

SIZEMENU 

IHLCOL 

SMOVEPIC 

SETCOLORS 

MCLINE 

INQUIREMENU 

ESMOVEPIC 

SAVECOLORS 

MC POINT 

LISTMENU 

CURLOADPIC 

L0ADC0L0RS 

MC2UTM 

WHEREMENU 

CCOLOR 

UTMLINE 

CAP 

CZOOM 

ZONCHG 

CSXY 

HZOOM 

ZONECHANGE 

CSX 

REZOOM 

MAPNAME 

CSY 

UPZOOM 

SELMAPS 

CHANGETEXT 

ZOOM 

PANORG 

REFMAP 

REFPIX 

RECTMAP 

SETCLIP 

SETORIGIN 

CURORIGIN 


SPDRAWROADS 

SPDRAWVEG 

SPFASTVEG 

FASTDRAWVEG 

BDRAWVEG 


ILVuVUV 


w 


The  function  of  Individual  keywords  within  these  groups  are  as  follows: 
Graphics: 

1.  ERASE  Clears  all  three  viewable  planes. 

2.  ERASE1  Clears  the  bottom  plane  (where  the  map  Is  drawn). 

3.  ERASE2  Clears  the  middle  plane. 

4.  ERASE3  Clears  the  top  plane  (where  the  unit  data  are  drawn). 

5.  SELERASE  Selectively  erases  a  part  of  any  plane. 

6.  MAPERASE  Erases  a  plane  using  a  selected  color. 

7.  RECTMAP  Draws  a  rectangle  around  a  defined  portion  of  the  map 

8.  SAVEPIC  Saves  the  current  map  to  a  file. 

9.  LOADPIC  Loads  a  map  from  a  file. 

10.  SP  LOADPIC  Enters  a  single  particular  .pic  file. 

11.  SETCOLORS  Can  change  the  colors  on  each  plane. 

12.  SAYECOLORS  Saves  the  changes  made  with  SETCOLORS  in  a  file. 

13.  L0AX0L0RS  Loads  color  file  previously  saved. 

14.  CCOLOR  Changes  color  of  a  plane. 

15.  CZOOM  Zooms  on  cursor  position.  Repeating. 

16.  HZOOM  Hardware  zoom  using  0,0  as  x,y  min. 

17.  REZOOM  Defaults  back  to  original  screen  size. 

18.  UPZOOM  Multiple  zooms  around  a  point. 

19.  ZOOM  Sets  with  cursor  the  software  zoom  window  center. 

20.  PANORG  Zooms  and  pans  across  the  picture. 

21.  SETCLIP  Sets  viewable  window  size. 

22.  CURORIGIN  Moves  the  0,0  point  to  a  spot  picked  by  cursor. 

23.  SETORIGIN  Moves  the  0,0  point  to  a  spot  Input  by  keyboard. 


Terrai n : 

1.  SETCOORD  Creates  own  grid  pattern.  Will  erase  current  map. 

2.  MAPSIZE  Draws  grid  according  to  military  coordinates  (coords) 

3.  SETFEATURE  Draws  submenu  to  select  features  active. 

4.  DRAWGRID  Draws  grid  according  to  coord  system  In  use. 

5.  DRAWBORDER  Draws  any  border  previously  defined  in  the  pic  file. 

6.  DRAWROADS  Draws  the  roads  previously  defined  for  this  pic  area. 

7.  DRAWVEG  Draws  the  vegetation  for  this  pic  area. 

8.  DRAWCITY  Draws  the  city  names  defined  for  this  pic  area. 

9.  WHERE  Gives  pixel  and  map  coords  for  cursor  position. 

10.  WHEREMC  Converts  cursor  position  into  military  coords. 

11.  MCPOINT  Draws  a  point  at  a  given  military  coord. 

12.  MCLINE  Draws  a  line  between  military  coords. 

13.  UTMLINE  Draws  a  line  using  UTM  coords. 

14.  MC2UTM  Translates  military  coords  to  UTM  coords. 

15.  ZONCHG  Changes  zones  using  the  cursor  as  coord  input. 

16.  ZONECHANGE  Changes  from  one  zone  to  another  in  UTM  coords. 

17.  SELMAPS  Draws  a  global  map  showing  which  maps  are  defined. 

18.  MAPNAME  Using  cursor,  displays  which  map(s)  are  being  used. 

19.  SPDRAWROADS  Displays  a  specific  map  file,  entered  from  keyboard. 

20.  SPDRAWVEG  Displays  a  specific  veg  file,  entered  from  keyboard. 

21.  SPFASTVEG  Faster  version  of  SPDRAWVEG. 

22.  FASTDRAWVEG  Draws  vegetation  maps  faster  than  DRAWVEG. 


Menu  util : 

1.  SELECTMENU 

Selects  menu  to  work  with. 

2.  DRAWMENU 

Displays  to  screen  the  menu  loaded. 

3.  ERASEMENU 

Erases  selected  menu  from  screen. 

4.  SAVEMENU 

Saves  selected  menu  to  local  file. 

5.  LOADMENU 

Loads  a  menu  from  the  .MEN  file. 

6.  M SAVEMENU 

Saves  a  master  menu  to  local  file. 

7.  MLOAOMENU 

Loads  a  master  menu  from  the  .MEN  file. 

8.  DEFINEMENU 

Selects  menu  size,  position  and  color. 

9.  SHOWMENU 

CRT  displays  menu  attributes. 

10.  CHANGETEXT 

Alters  text  within  a  menu  field. 

11.  WHEREMENU 

Using  cursor,  establishes  menu  coordinates. 

12.  CSXY 

Draws  menu  at  cursor  origin  starting  at  upper  left. 

13.  CSX 

Draws  menu  at  cursor  x  origin,  y  unchanged. 

14.  CSY 

Draws  menu  at  cursor  y  origin,  x  unchanged. 

15.  CAP 

Text  size  of  capitals. 

16.  GRIDMENU 

Draws  the  menu  boxes  with  no  text. 

17.  SIZEMENU 

(not  active) 

18.  INQUIREMENU  Gives  menu  attributes  for  particular  menu. 

19.  LISTMENU 

Lists  current  menus  available. 

Menu  define: 

1.  STARTX 

Starting  x  position  for  menu  draw. 

2.  STARTY 

Starting  y  position  for  menu  draw. 

3.  ITXLNG 

Widens  menu  box  for  text  length. 

4.  ITXSZ 

Alters  text  and  box  size  to  accomodate  text. 

5.  NUMBRX 

Number  of  columns  across  for  menu. 

6.  NUMBRY 

Number  of  rows  down  for  menu. 

7.  IGRPLN 

Plane  to  draw  grid  on. 

8.  IGRCOL 

Color  grid  to  be  drawi  In. 

9.  ICHPLN 

Plane  to  draw  text  on. 

10.  ICHCOL 

Color  text  to  be  drawn  In. 

11.  IHLCOL 

Highlighting  color. 

1  Slide: 

1.  SELCOLOR 

Selects  color  for  drawing. 

2.  SELPLANE 

Selects  plane  to  draw  on. 

3.  SELTEXTSIZE 

Selects  text  size  for  display. 

4.  SELTEXTDIR 

Direction  of  text  display. 

5.  LINEDRAW 

Draws  line  on  CRT  using  defined  colors  and  plane. 

6.  TEXTDRAW 

Draws  a  text  string  using  defined  colors  and  plane. 

7.  RECTOR AW 

Draws  rectangle  on  CRT  using  defined  color  and  plane. 

8.  REMOVE 

Erases  last  text,  line,  or  rectangle  drawn. 

9.  MOVEPIC 

Moves  part  of  the  picture  with  cursor. 

10.  EMOVEPIC 

Erases  and  moves  part  of  the  picture. 

11.  SMOVEPIC 

Saves  and  moves  part  of  the  picture. 

12.  ESMOVEPIC 

Erases,  saves,  and  moves  part  of  the  picture. 

13.  CURLOADPIC 

1 

i 

1 

> 

Loads  a  picture  file  using  cursor  as  0,0  reference. 
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Other: 


1.  HELP  Toggles  on  and  off  the  help  utility. 

2.  DCL  CMD  Allows  system  commands  from  Inside  VIP. 

3.  DEMOLOAD  (demo  file  not  present) 

4.  UNHID  Goes  Into  unit  Id  generator. 

5.  END  Stop  program. 


Most  of  these  keywords  are  available  by  using  the  utility  menus.  The 
utility  menu  Is  reached  from  the  main  menu. 


c.  Unit  nenu.  The  unit  menu  contains  the  function  options  to  deploy  units 
to  starting  positions  (If  there  are  no  defined  locations  In  ID  GEN).  It  also 
allows  for  creation  of  new  units,  copy  of  units,  and  deletion  of  unwanted 
units.  Individual  data  entries  (l.e.,  Initial  mass,  prototype,  radius,  delta, 
and  orientation)  can  be  entered  at  this  time.  Units  are  stored  In  direct 
access  file  DA_DATA:UNIT#.DAT. 

MAIN  MENU  Return  to  main  menu. 

Asks  If  data  has  been  recorded,  because  If  a  different 
data  type  Is  selected,  all  previous  data  are  deleted. 
Answer  YES/NO. 

If  answer  Is  NO,  the  previous  menu  Is  displayed  so  that 
the  data  may  be  recorded. 

PATH  PT  MENU  Path  point  menu  to  create  routes  for  the  units.  The 
UNIT#. DAT  Is  still  the  file  being  worked  on. 

See  paragraph  3d  for  more  Information. 

INPUT/OUTPUT  Draws  the  Input/output  menu,  at  the  bottom  of  the  screen 
to  read,  record,  and  print  data. 

See  paragraph  3r  for  more  Information. 

GRAPHICS  Draws  the  graphics  menu  at  the  bottom  of  the  screen  for 

loading  and  manipulation  of  picture  files. 

See  paragraph  3q  for  more  Information. 

SELECT  UNIT  Select  new  unit  by  touching  unit  with  the  cursor. 

Selected  unit  Is  highlighted. 

NEW  UNIT  Create  a  new  unit.  The  size  of  the  unit  will  be  taken 

to  be  the  last  values  of  frontage  and  depth.  Select  the 
position  of  the  center  of  the  unit  with  the  cursor. 

The  unit  Is  drawn  in  highlight  color  at  the  cursor 
postion. 

COPY  UNIT  Copy  the  selected  unit  to  produce  a  new  unit  at  a  new 

location.  If  no  unit  has  been  selected,  you  are  prompted 
to  select  a  unit  to  copy.  After  selection,  that  unit  will 
be  highlighted.  Select  position  for  center  of  the  new 
unit.  A  unit  Is  drawn  In  the  new  location  and 
highlighted.  Subsequent  pressing  of  the  cursor  In  the 
map  area  produces  more  copies.  To  terminate,  select  from 
menu  area. 

DEPLOY  UNIT  Move  unit  to  new  location.  If  no  unit  has  been  selected, 
select  unit.  Select  new  position  for  the  center  of  the 
unit.  The  unit  Is  redrawn  and  highlighted  at  the  new 
location.  If  the  unit  has  a  path  and  the  new  position 
for  the  unit  Is  not  on  that  path,  then  the  path  point  for 
the  unit  is  moved. 


MIL  COORD 

UNIT  10 

SET  SYMBOL 

RADIUS 

DELETE  UNIT 

I NIT  MASS 

PROTOTYPE 

UNIT  RADIUS 

UNIT  DELTA 


Draws  a  triangle  on  the  screen  at  selected  location. 

Enter  military  coordinates  and  zone  number  of  location. 

Name  of  unit.  Enter  up  to  12  alphanumeric  characters. 

The  name  Is  checked  against  the  unit  currently  held  In 
the  computer  and  against  the  unit  file  loaded  to  ensure 
that  the  name  Is  unique.  If  there  Is  already  a  unit  In 
the  computer  by  the  name.  It  Is  highlighted. 

Select  new  symbol  for  selected  unit.  Symbols  are  created 
using  the  symbol  generator  program.  The  first  character 
of  the  unit  name  Is  combined  with  the  symbol  number  to 
Identify  the  symbol.  Enter  the  number  of  the  new  symbol. 
The  new  symbol  Is  highlighted.  Symbols  are  displayed  as 
Bxxx  or  Rxxx  by  side.  This  option  allows  the  user  to 
change  the  three-digit  TOE  number  associated  with  the 
unit.  See  paragraph  3f  for  TOE  listing. 

Draw  a  circle  of  specified  radius  centered  on  the  unit 
location.  Enter  the  radius  of  the  circle. 

Select  unit  to  be  deleted.  Deletes  data  on  selected  unit 
and  removes  It  from  the  screen.  The  unit  Is  only  deleted 
from  local  memory.  The  file  In  DA_DATA :  remains  Intact 
until  deleted  or  overwritten.  Further  units  may  be 
deleted  by  selecting  with  the  cursor.  CAUTION:  This 
function  Is  still  active  until  It  Is  deselected  by  making 
another  menu  selection. 

Initial  mass  of  the  unit  Is  derived  from  some  computation 
which  utilizes  some  system  of  assigning  a  value  or  weight 
to  each  piece  of  equipment  which  Is  organic  to  the  unit. 

Unit  prototype  number.  Identifies  generic  type  units 
which  have  common  attributes.  This  number  must  be 
between  1  and  the  total  number  of  prototypes. 

Radius  of  the  area  occupied  by  the  unit's  systems 
(meters).  This  circle  may  expand  or  contract  depending 
on  the  ground  combat  status  mappings  data  In  VIC. 

The  radius  of  the  circle  which  contains  one-half  of  the 
weapons  for  the  unit.  This  Is  the  basic  radius  which 
applies  when  the  unit  Is  considered  to  be  In  some 
"standard"  deployment. 


ORIENTATION 


Unit's  Initial  orientation  measured  In  degrees 
counterclockwise  from  east. 


d.  Path  point  menu.  This  screen  allows  the  creation  of  Individual  paths 
by  Inputlng  the  nodes  or  points  the  unit  Is  to  follow.  Multiple  paths  on  the 
same  route  are  made  easier  with  the  copy  path  function.  The  Individual  node 
data  as  to  point  type,  preparedness,  requirements,  and  wait  times  can  be 
entered  at  this  point. 

UNIT  MENU  Returns  to  unit  location  menu. 

TACT  MENU  Tactical  area  menu  for  VIC  ground  movement  module. 

If  no  unit  has  been  selected,  select  unit.  Tactical 
areas  are  automatically  recorded  In  DA  DATA: TACTAREAf.DAT 
where  #  Is  the  imlt  direct  access  file  i number.  If  no 
file  has  been  assigned,  prompts  for  the  file  number. 

RT  PLAN  MENU  Detailed  route  planning  menu. 

See  paragraph  31  for  more  Information. 

INPUT/OUTPUT  Draws  the  Input/output  menu,  at  the  bottom  of  the  screen 
to  read,  record,  and  print  data. 

See  paragraph  3r  for  more  Information. 

GRAPHICS  Draws  the  graphics  menu  at  the  bottom  of  the  screen  for 

loading  and  manipulation  of  picture  files. 

See  paragraph  3q  for  more  Information. 

SELECT  UNIT  Select  new  unit  by  touching  unit  or  path  with  the 
cursor.  Selected  unit  and  path  Is  highlighted. 

CREATE  PATH  Create  a  path  for  the  selected  unit,  or  add  to  an 
existing  path.  If  a  path  already  exists,  the  path 
Is  continued  from  the  last  node.  The  position  of 
each  node  of  the  path  is  selected  with  the  cursor. 

The  last  node  entered  may  be  deleted  by  selecting 
It  with  the  cursor.  To  complete  the  path,  press 
cursor  In  the  menu  area.  Then  the  nodes  of  the 
path  are  joined  and  highlighted.  If  the  unit  Is 
not  positioned  at  one  of  the  path  points,  the 
closest  end  of  the  path  Is  joined  to  the  unit. 

COPY  PATH  May  only  be  accessed  after  CREATE  PATH  has  been  keyed. 

Select  a  path  to  copy.  Select  the  first  and  last  nodes 
to  copy.  The  path  Is  highlighted.  Enter  any  new  nodes 
after  the  copied  path,  if  any.  To  complete  the  path, 
press  cursor  In  the  menu  area.  Then  the  nodes  of  the 
paths  are  joined  and  highlighted.  If  the  unit  is  not 
positioned  at  one  of  the  path  points,  the  closest  end  of 
the  path  Is  joined  to  the  unit. 

EDIT  PATH  Draw  the  edit  menu  at  the  bottom  of  the  screen  for  use 

In  modifying  Individual  nodes  within  paths. 

See  paragraph  3n  for  more  Information. 


DELETE  PATH 


Delete  the  path.  If  no  unit  Is  selected,  select 
unit  and  delete  Its  patn. 


SELECT  NODES 
POINT  TYPE 


PREPRD  STATE 

ENG  REQUIRED 

AREA  TYPE 


Select  first  and  last  path  points  for  which  data 
Is  to  be  entered. 

The  path  point  must  have  a  certain  type  associated 
with  It: 

IMED  -  Immediate 

DEF  -  Defense 

OLAY  -  Delay 

RESV  -  Reserve 

APZ  -  Air  pickup  zone 

ALZ  -  Air  landing  zone 

HBAS  -  Helo  base  point 

HATK  -  Helo  attack  point 

EBAS  -  Engineer  base  point 

NOTE:  Helicopter  units  that  fly  missions  must  be  given 
HBAS  point  types.  Engineer  units  that  carry  out 
missions  must  be  given  EBAS  point  types. 

Initial  prepared  state  of  the  path  point.  This  value 
lies  between  0.0  and  1.0  to  define  the  degree  to  which 
this  path  point  has  currently  been  prepared.  This 
parameter  may  be  omitted  for  Input  In  which  case  the 
model  resorts  to  default  values  as  follows:  1.0  for  DEF 
type  path  points,  0.0  otherwise. 

"Y"  Indicates  that  engineers  are  required  to  prepare 
the  path  point.  This  Is  a  toggle  selection,  default 
Is  no.  The  OLAY  and  DEF  are  the  only  types  of  points  that 
can  be  prepared  so  a  "Y"  against  any  other  path  point 
types  will  flag  an  error  and  terminate  VIC  on  loading. 

The  path  point  Is  defined  as  being  located  In  a 
particular  type  of  area: 

CFA  -  Covering  force  area 
MBA  -  Main  battle  area 
RESV  -  Reserve  area 
1ECH  -  First  echelon  area 
2ECH  -  Second  echelon  area 
REAR  -  Rear  area 

As  a  blue  unit  progresses  along  Its  path,  Its  role  Is 
reset  to  the  value  of  the  area  type.  The  red  units  are 
handled  In  a  different  manner.  The  area  type  of  their 
starting  point  defines  their  Initial  role,  then  their  role 
changes  as  a  result  of  decision  table  logic  only. 
Therefore,  the  area  type  associated  with  a  red  unit's  path 
points  Is  Irrelevant  except  for  the  starting  node. 


WAIT  TYPE 


Options  for  control  of  the  time  element  for  path 
point  events. 

SYNC  -  Synchronize 
DLTA  -  Delta  wait 
STAT  -  Static 
RGRP  -  Regroup 
RMOV  -  Remove 
RORG  -  Reorganize 

WAIT  TIME  Specifies  when  a  unit  departs  from  a  path  point 
when  simulating  without  table-driven  ground 
movements  (days,  hours,  minutes). 


e.  Tactical  menu.  The  tactical  menu  creates  tactical  areas  for  the  unit 
path  points.  The  file  Is  opened  and  the  tactical  areas  are  automatically 
recorded  In  DAJDATA:TACTAR£A#.DAT  where  #  Is  the  file  number  Inputted  for  the 
UNIT#. DAT  file.  The  tactical  area  numbers  are  assigned  to  the  path  points. 
These  numbers  are  written  to  the  unit  file  and  correspond  directly  to  the 
tactical  area  file.  Both  these  files  after  going  to  OUTPUT:  are  combined  and 
used  In  the  VIC  global  ground  module  (.GG). 


PATH  PT  MENU  Returns  to  the  path  point  menu  and  saves  all  tactical 
areas  created. 


SELECT  UNIT 

DISPLAY  TAC 


CLEAR  TAC 


Select  unit  by  touching  with  cursor.  Selected 
unit  and  Its  path  are  highlighted. 

Display  tactical  area  for  path  point  of  selected  unit. 
Select  path  point  with  cursor.  The  tactical  area  assigned 
to  the  selected  path  point  Is  highlighted  and  the  path 
points  contained  within  the  tactical  area  are  highlighted. 

Clear  the  tactical  areas  from  the  screen  for 
the  selected  unit. 


NEW  TAC  Create  a  new  tactical  area.  New  tactical  areas  can 

only  be  created  where  no  tactical  area  exists.  If 
there  are  no  path  points  In  the  new  tactical  area. 

It  will  be  deleted.  The  position  of  each  node  of  the 
tactical  area  Is  selected  by  the  cursor.  To  complete 
the  tactical  area,  press  cursor  In  the  menu  area.  The 
nodes  of  the  tactical  area  are  joined  and  highlighted. 

COPY  TAC  Copy  the  selected  tactical  area  to  produce  a  new  tactical 

area  at  a  new  location.  Select  a  node  to  copy,  select 
position  for  node.  A  tactical  area  is  drawn  In  the  new 
location  and  highlighted.  Path  points  within  the  new 
tactical  area  are  highlighted.  If  no  unassigned  path 
points  lie  In  the  new  tactical  area.  It  will  be  deleted. 
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COPY  UNT  TAC  Copy  all  tactical  areas  from  the  selected  unit 
to  the  current  unit. 

REMOVE  P  PT  Remove  path  points  from  tactical  area.  Select  each  path 
point  to  be  removed  with  the  cursor.  If  there  are  no  path 
points  within  the  tactical  area.  It  wfll  not  be  deleted 
since  It  could  be  used  by  another  unit. 

MOVE  Move  tactical  area  to  new  location.  Select  node  to 

reposition.  Select  new  position  for  node.  Tactical  area 
Is  redrawn  at  new  location  and  highlighted.  Determine 
which  path  points  are  In  the  tactical  area  and  highlight. 

SHOW  ALL  TAC  Display  the  tactical  areas  for  all  path  points 
of  all  units. 

EDIT  TAC  Draw  the  edit  menu  at  the  bottom  of  the  screen  for  use 

In  editing  Individual  tactical  fields. 

See  paragraph  3o  for  more  Information. 

TAC  DEFAULT  Construct  a  default  tactical  area  for  each  path  point  of 
selected  unit.  The  tactical  area  encompasses  the  path 
point  to  each  side  of  the  selected  one  and  extends  a 
distance  of  one  unit  radius  beyond.  The  width  of  the 
area  Is  one  unit  radius  to  either  side. 

PRINT  DATAMC  Prints  data  on  all  tactical  areas.  Coordinates  are 

printed  in  military  coordinates  or  UTM  coords  depending  on 
whether  the  parameter  PRINT  UTM  Is  switched  on  or  off. 
Input  the  output  file  number:  Enter  #  (file  number)  to 
produce  a  VIC  file  TACTAREAf.OUT.  Note  tactical  area  data 
cannot  be  printed  to  the  CRT. 

PRINT  TACS  Print  data  on  the  tactical  areas  of  the  units  which  are 
currently  In  the  computer.  Coordinates  are  printed  In 
military  coordinates  or  UTM  coords  depending  on  whether 
the  parameter  PRINT  UTM  Is  switched  on  or  off.  Input  the 
output  file  number:  Enter  #  (  file  number  )  to  produce  a 
YIC  file  TACTAREAf.OUT. 

READ  VIC  FILE  Read  from  a  sequential  VIC  data  file  and  record  data  In  a 
direct  access  file  TACTAREAf.DAT.  Enter  VIC  file  name 
-.OUT.  Are  coords  In  military  coords?  Answer  YES/NO.  If 
reading  UTM,  enter  coords  of  the  VIC  origin. 


f.  Unit  ID  Generator.  The  selection  of  this  option  will  go  to  the  unit 
menu  and  ask  for  you  to  enter  a  file  number.  If  a  file  number  has  been 
previously  assigned,  you  will  go  directly  to  UNIT  ID  GENERATOR.  This  number 
becomes  the  #  part  of  the  file  DA_DATA:UNIT#.DAT. 

This  menu  allows  creation  of  Individual  units,  locations,  and  TOE  numbers  for 
all  sides.  The  unit  numbers  are  created  by  selection  from  the  Individual  force 
structure  menus.  The  selection  Is  highlighted  and  the  appropriate  number  is 
displayed  In  the  force  structure  box.  Numbers  greater  than  9  are  referenced 
alphabetically  (10  *  A,  11  *  B,  etc.).  Any  menu  not  selected  displays  a 
blank  In  the  force  structure  box.  If  a  zero  Is  required,  select  the 
appropriate  empty  box  In  the  menus. 

Entering  the  unit  location  Is  optional.  Units  with  no  defined  location  are 
displayed  In  the  upper  right  corner  of  the  screen  when  the  unit  file  is  read 
In.  If  the  user  wants  to  enter  a  location  while  In  UNIT  ID  GENERATOR,  all 
coordinates  are  expressed  In  military  coordinates. 

The  unit  TOE  number  Is  the  last  group  of  three  boxes  to  fill  in.  Menu 
selections  are  the  same  procedure  as  the  unit  force  structure.  A  listing  of 
all  TOE  numbers  with  defined  symbols  Is  provided. 

(THE  FUNCTIONS  CHANGE,  DELETE,  SAVE,  AND  LOAD  ARE  NOT  OPERATIONAL  AND  DEFAULT 
TO  THE  UNIT  MENU.)  Upon  exit  of  menu,  you  go  to  the  unit  menu. 


1 

RED  FORCE 

8LUE  FORCE 

ORANGE  FORCE 

GREEN  FORCE 

1 

001 

001 

101-102 

NONE  DEFINED 

I 

101-124 

101-104 

104-115 

126-132 

106-107 

201-223 

140-143 

109 

301-304 

' 

201-239 

113-114 

401-404 

241-245 

116 

501-502 

1 

251-252 

119-121 

Jj 

301-313 

201-214 

? 

316-318 

216 

K 

320-323 

218-224 

t* 

327-328 

226-230 

E 

330-331 

232-233 

1 

333 

236-238 

337-338 

241-243 

* 

gi 

340 

247-249 

401-404 

251 

5 

406-408 

261 

( 

410 

322-324 

I 

501-505 

422-424 

I 

601-606 

522-523 

n 

611-612 

g.  Subordinate  menu.  This  menu  assigns  the  superior/ subordinate 
structure.  This  menu  uses  as  Input  the  UNITf.DAT  file  but  the  output  of  this 
menu  creates  the  file  DA  DATA: UN IT#. SUB. 


MAIN  MENU  Return  to  main  menu.  Asks  If  data  has  been  recorded, 

because  If  a  different  data  type  Is  selected  all 
previous  data  are  deleted.  Answer  YES/NO. 

If  answer  Is  NO,  the  previous  menu  Is  displayed  so 
that  the  data  may  be  recorded. 

INPUT/OUTPUT  Draws  the  Input/output  menu,  at  the  bottom  of  the  screen 
to  read,  record,  and  print  data. 

See  paragraph  3r  for  more  Information 

GRAPHICS  Draws  the  graphics  menu  at  the  bottom  of  the  screen  for 

loading  and  manipulation  of  picture  files. 

See  paragraph  3q  for  more  Information. 

SELECT  UNIT  Select  new  unit  with  cursor.  Selected  unit  Is 
highlighted. 

SUBORDINATES  Select  subordinates  for  current  (highlighted)  unit. 

Current  unit  and  Its  subordinates  are  highlighted. 

Data  are  displayed  on  the  CRT. 

PHASE  GROUP  Select  units  which  belong  to  the  same  phase  group. 

Select  units  are  assigned  the  same  phase  group  number. 

Data  are  displayed  on  the  CRT.  A  phase  group  is  a  set  of 
specific  ground  units  which  will  at  some  time  need  to 
coordinate  their  movement.  Units  will  remain  at  a 
designated  position  until  all  other  units  In  that  phase 
group  have  reached  their  own  designated  wait  positions. 
Then  all  units  of  that  phase  group  will  begin  movement 
to  the  next  designated  positions. 

LEADING  ECH  Select  the  leading  echelon  for  red  units.  Initially 
Identifies  which  unit  Is  to  be  followed  by  this  unit 
at  the  start  of  the  campaign.  Data  are  displayed  on  the 
CRT.  This  pointer  can  be  dynamically  changed  during  the 
run  by  the  decision  tables. 

COORD  GROUP  Select  units  which  belong  to  the  same  coordination 

group.  Select  units  are  assigned  the  same  coordination 
group  number.  Data  are  displayed  on  the  CRT.  Units  given 
no  paths  can  move  automatically  whenever  another  specified 
unit  moves  along  a  designated  path  and  will  remain  at  the 
same  offset  distance  from  that  imit.  Only  one  member 
can  have  a  path.  If  not,  the  program  will  flag  the  fact 
that  there  can  only  be  one  leader  of  the  group  and  the 
model  will  abort  the  run. 


h.  Communications  menu.  This  menu  creates  and  defines  communications 
networks.  This  menu  uses  as  Input  the  UNITf.DAT  file  but  the  output  of  this 
menu  creates  the  file  DAJDATA:UNIT#.NET. 

MAIN  MENU  Return  to  main  menu.  Asks  If  data  have  been  recorded, 

because  If  a  different  data  type  Is  selected,  all  previous 
data  are  deleted.  Answer  YES/NO.  If  answer  Is  NO,  the 
previous  menu  Is  displayed  so  the  data  may  be  recorded. 

INPUT/OUTPUT  Draws  the  Input/output  menu,  at  the  bottom  of  the  screen, 
to  read,  record,  and  print  data. 

See  paragraph  3r  for  more  Information. 

GRAPHICS  Draws  the  graphics  menu  at  the  bottom  of  the  screen  for 

loading  and  manipulation  of  picture  files. 

See  paragraph  3q  for  more  Information. 

SELECT  UNIT  Select  new  unit  with  cursor.  Selected  unit  Is 
highlighted. 

NEXT  NET  If  multiple  nets  have  already  been  defined,  this  function 

will  display  and  highlight  the  next  network.  If  the  case 
of  the  displayed  network  Is  the  last  network,  the  first 
network  will  be  displayed. 

NEW  NET  Used  for  the  creation  of  new  networks.  First  unit 

selected  Is  highlighted.  This  unit  now  serves  as  the 
central  axis  for  the  network.  Subsequent  selection  of 
units  Includes  those  units  In  that  network.  All  linked 
units  are  displayed  with  a  line  showing  Its  linkage. 

ADD/DEL  MEMB  Allows  for  the  addition  and/or  deletion  of  units  from  a 
specific  network  by  selecting  that  unit  while  the  network 
which  contains  that  unit  Is  highlighted. 

NET  TYPE  The  network  type  can  now  be  entered  In  alphanumeric 

characters. 

SYSTEM  NAME  System  name  Is  entered  using  the  alphanumeric  submenu. 

DEL  SYSTEM  Delivery  system  name  Is  entered  using  the  alphanumeric 
submenu. 

LINKS  /  NODE  The  average  number  of  channels  per  node  is  entered  using 
the  numeric  submenu. 


TYPE  DATA 


The  type  of  data  Is  entered  using  the  numeric  submenu. 


ANT  POLAR 


Antenna  polarization  number  Is  entered  using  the  numeric 
submenu. 


TIME  SWITCH  Time  switch  system  number  Is  entered  with  the  numeric 
submenu. 

TRANSM  GAIN  Transmitter  gain  Is  entered  using  the  numeric  submenu. 
RECEVER  GAIN  Receiver  gain  Is  entered  using  the  numeric  submenu. 
TRANSM  HT  Transmitter  height  In  meters. 

RECEIVER  HT  Receiver  height  In  meters. 

TRANSM  POWER  Transmitter  power  Is  entered  using  the  numeric  submenu. 

TRANSM  FREQ  Transmitter  frequency  Is  entered  using  the  numeric 

submenu. 


1.  Route  plan  menu.  NOT  REQUIRED  FOR  VIC  FILES.  This  menu  allows  for 
travel  via  individual  roads  or  cross-country.  Allows  for  the  calculation  of 
distances  and  time  requirements  for  Individual  units.  Can  go  to  PATH  POINT 
MENU  or  back  to  MAIN  MENU.  To  plan  the  detailed  route  between  path  points. 
The  route  for  each  unit  is  stored  In  a  separate  direct  access  file 
DA_DATA:UNITID.ROT 

MAIN  MENU  Return  to  the  main  menu.  Asks  if  data  have  been 

recorded,  because  if  a  different  data  type  is  selected, 
all  previous  data  are  deleted.  Answer  YES/NO.  If  the 
answer  Is  NO,  the  previous  menu  is  displayed  so  that 
the  data  may  be  recorded. 

PATH  PT  MENU  Path  point  menu  to  create  routes  for  the  units. 

INPUT/OUTPUT  Draws  the  Input/output  menu  to  read,  record,  and  print 

data. 

GRAPHICS  Draws  the  graphics  menu. 

X-COUNTRY  Create  a  new  path  from  node.  Select  node.  Enter  nodes 

of  the  detailed  path  for  off-road  travel.  ROAD  TRAVEL 
may  be  access  for  path  of  the  route.  Access  is  also 
available  to  NEAREST  NODE. 

ROAD  TRAVEL  Select  a  path  following  the  roads.  Select  the  node  of 
the  path  from  which  road  travel  is  required.  If  the 
road  types  have  not  been  selected,  select  road  types. 
Select  the  start  and  end  points  of  the  path  with  the 
cursor.  If  the  start  or  end  points  are  not  at  a  node, 
select  the  first  and  last  nodes  which  are  on  the  road 
junctions.  If  there  is  more  than  one  option  for  the 
path  at  any  point,  select  from  nodes  displayed.  When 
the  path  is  complete,  the  nodes  of  the  path  are  joined. 

SELECT  ROADS  Select  the  type  of  roads  for  ROAD  TRAVEL: 

AUTOBAHNS 
MAIN  ROADS 
SECONDARY  ROADS 
FAIR  WEATHER  ROADS 
RAILWAYS 

Selected  types  are  highlighted. 

SELECT  UNIT  Select  unit  with  the  cursor,  highlight  and  draw  nodes 
of  its  path.  The  detailed  route  is  drawn  between  the 
nodes  if  it  exists. 

RETURN  TR  Return  the  traffic  regulator  to  its  first  path  point. 

SELECT  NODE  Select  node  of  path. 


NEAREST  NODE  Find  the  nearest  node  on  the  road  network.  Select 

position  with  the  cursor.  The  nearest  node  Is  displayed. 

UPDATE  TIMES  If  this  Is  switched  on,  then  when  a  time  Is  changed  for 
a  node,  all  times  for  subsequent  nodes  are  updated. 

POSITION/TIM  Draw  all  the  units  at  their  locations  at  a  specified 
time.  Enter  time  (days,  hours,  minutes). 

DELETE  ROUTE  Delete  whole  of  the  detailed  path  for  selected  unit. 

COPY  PATH  Select  unit  to  copy.  The  detailed  route  and  the  nodes  are 

copied.  The  unit  is  moved  to  the  end  of  the  copied  path. 

EDIT  PATH  Edit  the  main  nodes  of  the  path.  The  detailed  route 

connected  to  nodes  which  have  been  edited  Is  removed. 

After  the  path  Is  edited,  the  detailed  route  is  redrawn. 

RT  PLAN  DATA  Draw  the  route  plan  data  menu. 

NEW  UNIT  Create  a  new  unit.  Select  the  position  of  the  center 

of  the  unit  with  the  cursor.  The  unit  is  drawn  in 
highlight  color  at  the  cursor  postion. 

DEPLOY  UNIT  Move  unit  to  new  location.  If  no  unit  has  been  selected, 
select  unit.  Select  new  position  for  the  center  of  the 
unit.  Redraw  and  highlight  unit  at  new  location.  If  the 
unit  has  a  path  and  the  new  position  for  the  unit  Is  not 
on  that  path,  then  the  path  point  for  the  unit  is  moved. 

CREATE  PATH  Create  a  path  for  the  selected  unit.  The  position  of  each 
node  of  the  path  Is  selected  with  the  cursor.  The  last 
node  entered  may  be  deleted  by  selecting  It  with  the 
cursor.  To  complete  the  path,  press  cursor  in  the  menu 
area.  Nodes  of  the  path  are  joined  and  highlighted. 
Closest  end  of  the  path  is  joined  to  the  unit. 


To  enter  the  data  for  each  node  of  the  path. 


ARRIVE  TIME 
DEPART  TIME 
END  TIME 
POSTURE 


COL  LEN  NODE 
COL  DIA  NODE 
COL  LEN  PATH 
COL  DIA  PATH 
ALTITUDE 


Enter  the  arrival  time  at  the  node  (days,  hours,  minutes) 

Enter  the  time  to  leave  the  node  (days,  hours,  minutes). 

Enter  the  time  to  arrive  at  next  node  (days,  hours,  mins) 

Posture  for  the  node,  or  for  traveling  from  the  node. 
ASSEM-AREA  MARCH  FIRING-POSITION 

TAC-A-AREA  MOVE-CONTACT  DESTROYED 

IN  COLUMN  ATTACK  AIR-PICK-UP 

IMP-POSITION  DELAY  AIR-LANDING 

HASTY -DEF  HELI-BORNE  TAC-MARCH 

DELIB-DEF 

Column  length  of  unit  at  the  node  (km). 

Column  diameter  of  unit  at  the  node  (km). 

Column  length  of  unit  on  path  from  the  node  (km). 

Column  diameter  of  unit  on  path  from  the  node  (km). 
Altitude  (m). 


j.  Minefield  menu.  Menu  for  the  creation  and  alteration  of  Individual 
minefields.  Allows  data  Input  on  each.  Data  Is  stored  In  DA_DATA: 

MINEFIELD#. DAT.  This  menu  can  only  be  reached  from  and  return  to  the  main 
menu.  When  sent  to  the  directory  OUTPUT:  this  file  becomes  part  of  the 
VIC  module  labeled  minefields  (.MF). 

MAIN  MENU  Return  to  main  menu.  Asks  If  data  have  been  recorded. 

because  If  a  different  data  type  Is  selected,  all 
previous  data  are  deleted.  Answer  YES/NO.  If  answrr 
Is  NO.  the  previous  menu  Is  displayed  so  that  the 
data  may  be  recorded. 

INPUT/OUTPUT  Draws  the  Input/output  menu  at  the  bottom  of  the  screen 
to  read,  record,  and  print  data. 

See  paragraph  3r  for  more  Information. 

GRAPHICS  Draws  the  graphics  menu  at  the  bottom  of  the  screen  for 

loading  and  manipulation  of  picture  files. 

SELECT  MNFLD  Select  new  minefield  by  touching  the  minefield  with 
the  cursor.  Selected  minefield  Is  highlighted. 

NEW  MINEFLD  Create  a  new  minefield.  The  position  of  the  center  of 
the  minefield  Is  selected  with  the  cursor.  The  size 
of  the  minefield  will  be  taken  to  be  the  last  values  of 
frontage  and  depth.  If  DENSITY  FACT  has  been  set,  the 
number  of  mines  Is  calculated. 

COPY  MINEFLD  Copy  the  selected  minefield  to  produce  a  new  minefield 
at  a  new  location.  If  no  minefield  has  been  selected, 
select  a  minefield  to  copy.  The  minefield  Is  highlighted. 
Select  position  for  the  center  of  the  minefield.  A 
minefield  Is  drawn  in  the  new  location  and  highlighted. 
CAUTION:  The  copy  function  does  not  turn  off  until 
another  menu  selection  Is  made.  Subsequent  pressing 
of  the  cursor  in  the  map  area  produces  more  copies. 

To  terminate,  select  from  menu. 

MOVE  MINEFLD  Move  minefield  to  new  location.  If  no  minefield  has 
been  selected,  select  minefield  to  move.  Select  new 
position  for  the  center  of  the  minefield.  The  minefield 
Is  redrawn  and  highlighted  at  the  new  location.  The 
old  entity  Is  erased  from  the  screen  and  local  memory. 


DELETE  MNFLD 

DENSITY  FACT 

ENG  MISSION 

MINEFLD  # 

MINETYPE  NAM 

FRONTAGE 

DEPTH 

ORIENTATION 

NO  OF  MINES 


f 


Select  minefield  to  be  deleted.  Deletes  data  on  a 
selected  minefield  and  removes  It  from  the  screen.  The 
minefield  Is  only  deleted  from  local  memory.  The  file 
In  DAJ3ATA:  remains  Intact  until  deleted  or 
overwritten.  Further  minefields  may  be  deleted  by 
selecting  with  the  cursor.  CAUTION:  This  function  Is 
still  active  until  It  Is  deselected  by  making  another 
menu  selection. 

Input  the  density  factor  for  minefields.  The  number 
of  mines  •  FRONTAGE  *  DEPTH  *  DENSITY  FACTOR. 

Or  can  be  thought  of  as  number  of  mines  per  square  meter. 
This  function  can  be  overridden  as  required  by  the 
number  of  mines  option  below. 

Engineer  mission  number.  Select  with  the  cursor  from 
the  submenu  drawn  at  the  bottom  of  the  screen.  Groups 
together  those  minefields  In  the  same  engineer  mission. 

Enter  new  Identification  number  for  the  selected 
minefield. 

Minefield  type  name.  Enter  up  to  12  alphanumeric 
characters.  The  name  Is  checked  against  the  minefields 
currently  held  In  the  computer  and  against  the  catalog 
If  a  direct  access  file  Is  assigned,  to  ensure  that 
the  name  Is  unique.  If  there  Is  already  a  minefield 
In  the  computer  by  the  name,  it  Is  highlighted. 

Width  of  the  area  occupied  by  the  minefield  (meters). 

Use  the  cursor  to  enter  this  number  from  the  submenu 
at  the  bottom  of  the  screen. 

Depth  of  the  area  occupied  by  the  minefield  (meters). 

Use  the  cursor  to  enter  this  number  from  the  submenu 
at  the  bottom  of  the  screen. 

Orientation,  expressed  In  degrees  counterclockwise 
from  east.  Use  the  cursor  to  enter  this  number  from 
the  submenu  at  the  bottom  of  the  screen. 

Number  of  mines  In  the  minefield.  Input  -  ,  then 
the  number  of  mines  are  calculated. 

This  overrides  the  density  factor. 


START  TIME 


Activating  time  (days,  hours,  minutes).  Zero  means 
already  activated.  If  engineer  module  is  played, 
time  indicates  priority. 


k.  Barrier  menu.  Menu  for  the  creation  and  alteration  of  Individual 
barriers.  Allows  for  data  Input  as  to  type,  visibility,  and  trafflcablllty. 
This  menu  can  only  be  reached  from  and  return  to  the  main  menu.  Data  created 
In  this  menu  are  stored  In  the  file  DA  DATA:BARRIER#.DAT,  where  #  Is  the  file 
number  entered  by  the  user.  This  flleT  when  sent  to  the  OUTPUT:  directory 
(see  paragraph  3r),  later  combines  with  the  line  obstacle  data  file  to 
form  part  of  the  VIC  file  labeled  .TB  which  stands  for  terrain  and  barriers. 

MAIN  MENU  Return  to  main  menu.  Asks  If  data  have  been  recorded, 

because  If  a  different  data  type  Is  selected,  all 
previous  data  are  deleted.  Answer  YES/NO.  If  answer 
Is  NO,  the  previous  menu  Is  displayed  so  that  the 
data  may  be  recorded. 

INPUT/OUTPUT  Draws  the  Input/output  menu  at  the  bottom  of  the 
screen  to  read,  record,  and  print  data. 

See  paragraph  3r  for  more  Information. 

GRAPHICS  Draws  the  graphics  menu  at  the  bottom  of  the  screen 

for  loading  and  manipulation  of  picture  files. 

See  paragraph  3q  for  more  Information. 

SELECT  BAR  Select  new  barrier  by  touching  node  or  line  segment 

with  the  cursor.  Selected  barrier  is  highlighted  showing 
all  node  positions. 

NEW  BARRIER  Create  a  new  barrier.  The  position  of  each  node  of 
the  barrier  Is  selected  with  the  cursor. 

To  complete  the  barrier,  press  cursor  In  the  menu  area. 

The  nodes  of  the  barrier  are  joined  and  highlighted. 

COPY  BARRIER  Copy  the  selected  barrier  to  produce  a  new  barrier  at 
a  new  location  of  the  same  dimensions.  If  no  barrier 
Is  selected,  you  are  prompted  to  select  a  barrier  to 
copy.  The  selected  barrier  Is  highlighted  and  shows  all 
node  positions.  Select  a  node  to  copy.  This  becomes  the 
reference  point  In  placement  of  the  new  barrier.  Select 
position  for  node.  A  barrier  Is  drawn  in  the  new 
location  and  highlighted.  CAUTION:  The  copy  function  does 
not  turn  off  until  another  menu  selection  is  made. 
Subsequent  pressing  of  the  cursor  In  the  map  area  produces 
more  copies.  To  terminate,  select  from  menu  area. 

MOVE  BARRIER  Used  to  move  barrier  to  a  new  location.  If  no  barrier 
has  been  selected,  you  are  prompted  to  select  barrier. 
Barrier  becomes  highlighted  and  shows  all  node  positions. 
Select  node  to  reposition.  This  node  Is  the  cursor 
reference  point.  Select  new  position  for  node.  The 
barrier  Is  redrawn  and  highlighted  at  the  new  location 
while  the  old  entity  Is  erased.  The  barrier  can  be  moved 
until  another  selection  Is  made  In  the  menu  area. 


EDIT  BARRIER  Draw  the  edit  menu  at  the  bottom  of  the  screen  for  use 
In  modifying  the  nodes  within  Individual  barriers. 

See  paragraph  3n  for  more  Information. 

DELETE  BAR  Select  barrier  to  be  deleted.  Deletes  data  on  selected 
barrier  and  removes  It  from  the  screen.  The  barrier  Is 
deleted  from  the  local  file  only.  The  file  In 
DA_DATA:  remains  Intact  until  deleted  or  overwritten. 
Further  barriers  may  be  deleted  by  selecting  with  the 
cursor.  CAUTION:  This  function  is  still  active  until 
It  Is  deselected  by  making  another  menu  selection. 

BARRIER  #  Using  the  cursor,  enter  new  Identification  number  for 

the  selected  barrier  from  the  submenu  drawn  at  the  bottom 
of  screen. 

VISIBILITY  The  following  are  the  only  valid  data  ranges  and  their 
meanings  for  this  menu  entry- 
visibility:  1  *  good 

2  -  fair 

3  *  poor 

TRAFFICABLTY  The  following  are  the  only  valid  data  ranges  and  their 
meanings  for  this  menu  entry— 

Trafflcablllty:  1  ■  good 

2  ■  fair 

3  »  poor 

BARRIER  TYPE  The  following  are  the  only  valid  data  ranges  and  their 
meanings  for  this  menu  entry— 

Barrier  type:  1  ■  river 

2  *  passable  feature 

3  »  Impassable  feature 

4  ■  urban  area 

5  -  chemically  contaminated 

6  *  nuclear  contaminated 

7  ■  biologically  contaminated. 
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1.  Line  obstacle  menu.  Menu  used  for  the  creation  and  alteration  of 
Individual  line  obstacles.  Allows  for  data  Input  on  each  obstacle  as  to  owner, 
type,  delay  times,  and  other  essential  data  Items.  This  menu  can  only  be 
reached  from,  and  returns  to,  the  main  menu.  Data  created  are  stored  In  the 
file  DAJ)ATA:LINEOBSTCLE#.DAT,  where  #  Is  the  user  supplied  file  number. 

MAIN  MENU  Return  to  main  menu.  Asks  If  data  have  been  recorded, 

because  If  a  different  data  type  Is  selected,  all 
previous  data  are  deleted.  Answer  YES/NO.  If  answer 
Is  NO,  the  previous  menu  Is  displayed  so  that  the 
data  may  be  recorded. 

INPUT/OUTPUT  Draws  the  Input/output  menu  at  the  bottom  of  the  screen 
to  read,  record,  and  print  data.  See  paragraph  3r  of 
reference  manual . 

GRAPHICS  Draws  the  graphics  menu  at  the  bottom  of  the  screen. 

This  menu  Is  used  for  loading  and  manipulating  picture 
files.  See  paragraph  3q  for  more  Information. 

SELECT  OBSTL  Select  new  line  obstacle  by  touching  node  or  line 
segment  with  the  cursor.  Selected  line  obstacle  Is 
highlighted  showing  all  node  positions. 

NEW  OBSTACLE  Create  a  new  line  obstacle.  The  position  of  each  node  of 
the  line  obstacle  Is  selected  with  cursor.  To  complete 
the  line  obstacle,  press  cursor  In  the  menu  area.  The 
nodes  of  the  line  obstacle  are  joined  and  highlighted. 

COPY  OBSTCLE  Copy  the  selected  line  obstacle  to  a  new  line  obstacle 

at  a  new  location.  If  no  line  obstacle  has  been  selected, 
you  are  prompted  to  select  a  line  obstacle  to  copy.  The 
selected  line  obstacle  Is  highlighted  and  shows  all  node 
positions.  Select  a  node  to  copy.  This  becomes  the 
reference  point  In  placement  of  the  new  line  obstacle. 
Select  position  for  node.  A  line  obstacle  Is  drawn  In  the 
new  location  and  highlighted.  CAUTION:  The  copy  function 
does  not  turn  off  until  another  menu  selection  Is  made. 
Subsequent  pressing  of  the  cursor  In  the  map  area  produces 
more  copies.  To  terminate,  select  from  menu  area. 

MOVE  OBSTCLE  Move  line  obstacle  to  new  location.  If  no  line 

obstacle  has  been  selected,  you  are  prompted  to  select 
line  obstacle.  The  line  obstacle  becomes  highlighted  and 
shows  all  node  positions.  Select  node  to  reposition. 

This  node  Is  the  cursor  reference  point.  Select  new 
position  for  node.  The  line  obstacle  Is  redrawn  and 
highlighted  at  the  new  location  while  the  old  entity  Is 
erased.  The  line  obstacle  can  be  moved  until  another 
menu  selection  Is  made. 
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EDIT  LINE  OB 

Draw  the  edit  menu  at  the  bottom  of  the  screen  for  use 

In  modifying  the  nodes  within  Individual  line  obstacles. 

See  paragraph  3n  for  more  Information. 

DELETE  OB STL 

Select  line  obstacle  to  be  deleted.  Deletes  data  on 
selected  line  obstacle  and  removes  It  from  the  screen. 

The  line  obstacle  Is  deleted  from  local  memory  only. 

The  file  In  DA_DATA:  remains  Intact  until  deleted 
or  overwrlttenT  Further  line  obstacles  may  be  deleted 
by  selecting  with  the  cursor.  CAUTION:  This  function  Is 
still  active  until  It  Is  deselected  by  making  another 
menu  selection. 

FEATURE  # 

Using  the  cursor,  enter  new  Identification  number  for 
the  selected  line  obstacle  from  the  submenu  drawn  at  the 
bottom  of  the  screen.  A  number  identifying  the  line 
feature  of  this  obstacle  forms  a  part.  A  line  feature  may 
be  composed  of  several  obstacles,  each  one  having  a  unique 
prototype  along  Its  length. 

PROTOTYPE 

Line  obstacle  prototype  name.  Using  the  cursor,  enter 
up  to  12  alphanumeric  characters. 

ENG  MISSION 

Engineer  arissslon  number.  Zero  indicates  that  the 
obstacle  Is  active.  All  obstacles  having  the  same 
engineer  mission  number  will  be  constructed  serially  by 
the  same  engineer  unit  which  has  been  given  the  mission. 

OWNER  /  SIDE 

BLUE,  RED,  or  -.  (-  means  not  belonging  to  either  side). 

The  side  owning  the  obstacle  will  suffer  a  delay  equal  to 
the  breached  time. 

BREACH  TYPE 

Type  of  feature  for  breaching  purposed. 

1  -  brldgeable 

2  -  breachable 

DLAY  U8  BLUE 

The  delay  (In  hours)  suffered  by  a  blue  unit  upon 
encountering  this  obstacle,  given  that  it  has  not  been 
breached . 

OLAY  UB  RED 

The  delay  (In  hours)  suffered  by  a  red  unit  upon 
encountering  this  obstacle,  given  that  It  has  not  been 
breached . 

DLAY  B  BLUE 

The  delay  (In  hours)  suffered  by  a  blue  unit  upon 
encountering  this  obstacle,  given  that  it  has  been 
breached . 

OLAY  B  RED 

The  delay  (In  hours)  suffered  by  a  red  unit  upon 
encountering  this  obstacle,  given  that  It  has  been 
breached. 

25 

\v,v 


*.y?r,V 


SELECT  NODES  Select  nodes  to  define  the  segments  which  are  to  be 
breached. 

BREACHED  A  dashed  line  Is  placed  between  any  two  adjacent 

points  to  signify  that  that  segment  has  been  breached 
or  bridged.  A  letter  B  Is  placed  at  that  location 
point  In  the  data  file  to  signify  a  breached  section. 


m.  Network  menu.  This  Is  the  menu  for  the  creation  and  alteration  of 
network  links.  Data  are  stored  In  DAJJATA: NETWORK#. DAT. 

MAIN  MENU  Return  to  main  menu.  Asks  If  data  have  been  recorded, 

because  If  a  different  data  type  Is  selected,  all 
previous  data  are  deleted.  Answer  YES/NO.  If  answer 
Is  NO,  the  previous  menu  Is  displayed  so  that  the 
data  may  be  recorded. 

LOGISTC  MENU  Transfers  from  network  menu  for  logistics  data.  Data 
Input  In  logistic  menu  goes  to  the  same  file  as  the 
network  data. 

INPUT/OUTPUT  Draws  the  Input/output  menu  at  the  bottom  of  the  screen 
to  read,  record,  and  print  data. 

See  paragraph  3r  for  more  Information. 

GRAPHICS  Draws  the  graphics  menu  at  the  bottom  of  the  screen  for 

loading  and  manipulating  picture  files. 

See  paragraph  3q  for  more  Information. 

RENUMBER  ALL  Renumber  the  whole  road  network  In  order  of  Increasing  X- 
meaning  that  the  nodes  are  renumbered  from  west  to  east 
regardless  of  which  link  Its  In.  All  links  and  alternate 
nodes  are  renumbered.  Enter  the  Identification  number  of 
the  first  node.  Nodes  are  redrawn  with  the  new  numbers. 

RENUMBER  Renumber  a  selected  part  of  the  network  In  order  of 

Increasing  X.  All  links  and  alternate  nodes  are  also 
renumbered.  Select  all  nodes  which  are  to  be 
renumbered.  Enter  the  Identification  number  of  the 
first  node.  Nodes  are  redrawn  with  the  new  numbers. 

SET  SYMBOL  Select  new  symbol  for  all  subsequent  symbols  drawn. 

If  a  node  has  been  selected.  Its  symbol  will  be 
changed.  The  symbols  of  all  nodes  remain  unchanged. 

NODE  COLOUR  Select  new  drawing  color  for  nodes  from  menu.  If  a 
node  has  been  selected.  Its  color  will  be  changed. 

The  color  of  all  other  nodes  remain  unchanged. 

LINK  COLOUR  Select  new  drawing  color  for  links  from  menu.  The 
color  of  all  links  remain  unchanged. 


ROAD  DIST  Calculate  the  distance  along  the  roads  between  nodes. 

Select  the  two  nodes  which  define  the  link.  If  the 
road  types  have  not  been  selected,  select  road  types. 
Select  the  first  and  last  nodes  If  the  nodes  are  not  on 
road  junctions.  If  there  Is  more  than  one  option  for 
the  path  at  any  point,  select  from  the  nodes  displayed. 

NODE  #  Enter  new  Identification  number  for  the  selected  node. 

NEW  NODE  Create  a  new  node.  The  position  of  each  new  node  of 

the  network  Is  selected  with  the  cursor.  When  no 
further  nodes  are  required,  press  cursor  In  the  menu 
area. 

SELECT  NODE  Select  new  node  by  touching  node  with  the  cursor. 
Selected  node  Is  highlighted. 

MOVE  NODE  Move  node  to  new  location.  If  no  node  has  been 

selected,  select  node.  Select  new  position  for  node. 
Recalculate  distances  to  linked  nodes.  Redraw  and 
highlight  node  and  links  at  new  location.  The  node  can 
be  moved  until  the  cursor  Is  returned  to  the  menu  area. 

DELETE  NODE  Select  node  to  be  deleted.  Destroy  data  on  selected 
node  and  remove  from  the  screen.  All  links  from  other 
nodes  to  this  node  are  removed.  Further  nodes  may  be 
deleted  by  selecting  with  the  cursor. 

SHOW  LINKS  Highlight  all  the  links  for  the  currently  selected 
node.  If  not  selected,  select  node  and  highlight. 

REMOVE  LINK  Remove  link  between  two  nodes.  If  not  selected, 

select  node  and  highlight.  Select  node  to  which  link 
Is  to  be  removed.  Link  Is  deleted  from  screen. 

INSERT  LINK  Insert  link  between  two  nodes.  If  not  selected, 
select  node  and  highlight.  Select  node  to  link. 

Link  Is  drawn  between  the  two  nodes. 

CREATE  NET  Start  by  selecting  an  existing  node  or  by  pressing 
cursor  at  position  of  new  node.  Select  subsequent 
nodes  by  pressing  cursor  at  desired  location.  Each 
node  Is  linked  to  the  previous  one.  Nodes  are  given 
the  next  available  Identification  number  following 
that  of  the  first  node.  Complete  the  net  by  pressing 
the  cursor  In  the  menu  area.  If  the  symbol  menu  has 
been  drawn.  It  may  be  accessed  and  the  symbol  changed 
during  CREATE  NET. 


n.  Logistic  menu.  Assign  logistic  data  to  network.  Data  Is  stored  In  the 
file  NETWORK#. DAT. 

NETWORK  MENU  Returns  to  network  menu. 

INPUT/OUTPUT  Draws  Input/output  menu  to  read,  record,  and  print  data. 

GRAPHICS  Draws  the  graphics  menu. 

SELECT  NODE  Select  new  node  by  touching  node  with  the  cursor. 

Selected  node  Is  highlighted. 

SELECT  LINK  Select  connecting  node  for  data  Input. 

Selected  link  Is  highlighted. 

TYPE  NODE  Describes  the  Initial  status  of  the  node: 

BS  ■  Blue  supply  area  occupied  by  blue 

RS  ■  Red  supply  area  occupied  by  red 

B  -  Controlled  by  blue 

R  «  Controlled  by  red 

U  *  Unusable  node 

SUPPLY  SRVCE  Supply  service  performed: 

S  ■  Supply  only  to  forward  supply  units  and 
designated  maneuver  units 
SR  *  Supply  to  forward  supply  units  and  designated 
maneuver  units  and  receive  supplies  from  the 
designated  supply  sources 

R  «  Supplies  designated  maneuver  units/receives 
supplies  from  designated  supply  sources. 
Describes  the  type  of  service  that  Is  performed  from  this 
node  If  Its  type  designation  Is  "BS"  or  "RS". 

ASSX  UNIT  A  name  corresponding  to  a  unit  defined  In  the  global 
ground  module.  This  unit  will  be  associated  with  the 
forward  supply  area  in  order  that  the  supply  area  can  be 
a  target  for  Indirect  fire  attack. 

#  ALT  NODE  Node  numbers  of  the  backup  supply  points.  Input  in  order 
from  rear  area  to  forward  area.  Select  nodes  with  cursor. 

ADD  ALT  NODE  Add  alternate  node  by  entering  the  number  of  the 
alternate  node. 

ROAD  SURFACE  Code  for  the  road  surface  between  nodes: 

1  ■  Concrete  3  *  Gravel 

2  »  Bituminous  4  ■  Dirt 

ROAD  WIDTH  Code  for  the  road  width  between  nodes: 

1  ■  roadway  >»  24  feet  wide 

2  -  roadway  <  24  feet  wide 
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ROAD  TERRAIN  Code  for  the  predominate  terrain  characteristics 
between  nodes: 

1  «  flat  3  *  hills  with  curves 

2  ■  rolling  hills  4  =  mountainous 


o.  Edit  menu.  This  menu  allows  the  editing  of  line  segments  and  polygons. 
Upon  selecting  any  of  the  editing  options  (l.e.,  EDIT  LINE  OB,  EDIT  BARRIER, 
etc.),  this  submenu  will  be  drawn  at  the  bottom  of  the  screen.  Using  the 
cursor,  select  one  of  the  four  options.  You  can  continue  in  edit  mode  as  long 
as  required.  Select  from  the  data  menu  when  completed;  the  submenu  will  remain 
displayed  until  another  submenu  Is  drawn.  NOTE:  Once  changes  are  made,  the 
new  entitles  exist  only  In  the  local  memory  and  must  be  recorded  to  become  part 
of  the  file  residing  in  DA_DATA:  See  reference  manual  paragraph  3r  on 
Input/output. 

CHANGE  NODE  Change  the  location  of  a  node  within  a  line  segment. 

If  no  entity  Is  selected,  select  entity  (line  segment 
or  polygon)  and  It  will  become  highlighted  and  show 
all  node  positions  for  that  entity.  Select  node  to  be 
changed.  Select  new  position  for  node  and  the  new 
entity  will  be  drawn,  erasing  the  old  entity.  Other 
nodes  may  be  changed  until  next  menu  item  is  selected. 

REMOVE  NODE  Remove  a  node  from  the  line  segment.  If  no  entity  is 
selected,  select  entity  and  It  will  become  highlighted 
and  show  all  node  positions  for  that  entity.  Select 
node  to  be  removed  and  the  new  entity  will  be  drawn, 
erasing  the  old  entity.  Other  nodes  may  be  removed 
until  next  menu  Item  is  selected. 

INSERT  NODE  Insert  a  node  in  the  middle  of  a  line  segment.  If  no 
entity  Is  selected,  select  entity  and  It  will  become 
highlighted  and  show  all  node  postions  for  that  entity. 
Select  nodes  which  are  before  and  after  the  new  node. 
Select  the  position  for  the  new  node  and  the  new  entity 
will  be  drawn  erasing  the  old  entity.  Other  nodes  may 
be  Inserted  until  the  next  menu  Item  is  selected. 

ADD  NODE  Add  a  node  to  either  end  of  the  line  segment.  If  no 

entity  Is  selected,  select  entity  and  it  will  become 
highlighted  and  show  all  node  positions  for  that  entity. 
Select  the  node  at  the  end  of  path  to  add  node.  Select 
new  node  and  the  new  entity  will  be  drawn.  Other  nodes 
may  be  added  until  next  menu  item  Is  selected. 


p.  Parameters.  This  command,  which  can  only  be  entered  from  the  MAIN 
MENU,  allows  the  user  to  toggle  on  or  off  the  following  Items: 

DRAM  NAMES  Switched  on  -  draws  the  names  or  Identification 

numbers  by  each  entity. 

MOVE  MENUS  Moves  the  menus  to  the  other  side  of  the  screen. 

PRINT  UTM  Switched  off  -  the  data  files  are  printed  In 

military  coordinates. 

Switched  on  -  the  data  files  are  printed  In 
UTM  coordinates. 

AUTO  UNIT  Switched  on  -  the  units  are  automatically  drawn 

when  a  menu  of  another  type  Is  selected. 

AUTO  MINEFLD  Switched  on  -  the  minefields  are  automatically  drawn 

when  a  menu  of  another  type  Is  selected. 

AUTO  BARRIER  Switched  on  -  the  barriers  are  automatically  drawn 

when  a  menu  of  another  type  Is  selected. 

AUTO  LINE  OB  Switched  on  -  the  line  obstacles  are  automatically 

drawn  when  a  menu  of  another  type  Is 
selected. 


The  usefulness  of  this  menu  can  not  be  overemphasized.  Though  these 
parameters  are  options,  this  Is  the  only  way  to  display  a  data  file  while 
In  a  menu  of  a  different  type. 

The  PRINT  UTM  toggle  Is  a  requirement  for  producing  VIC  files.  If  this 
Is  not  selected,  the  data  contained  within  the  files  will  be  printed  to  the 
OUTPUT:  directory  In  military  coordinates.  This  Is  unsuitable  for 
VIC  input. 


q.  Graphics  menu.  The  command  GRAPHICS  can  be  entered  from  nearly  every 
menu.  Upon  the  selection  of  this  command,  a  submenu  will  be  drawn  at  the 
bottom  of  the  screen.  The  functions  of  this  menu  allow  the  input  of  a 
picture  file  to  the  screen.  Until  a  picture  has  been  loaded,  you  cannot  view 
on  the  screen  some  of  the  data  files  you  may  have  created  due  to  the  fact  that 
you  have  no  point  of  reference.  The  additional  functions  of  this  menu  allow 
for  the  manipulation  of  this  picture  or  the  data  displayed.  The  SET  COLOUR, 
CLEAR  FOREGO,  and  CLEAR  BACKGD  functions  do  not  affect  the  picture  in  any  way. 
These  functions  are  for  clearing  and  changing  the  drawing  color  in  the  upper 
planes,  where  the  data  are  displayed. 


Their  functions  are  as  follows: 

LOADPIC  Loads  and  draws  a  map  which  has  been  saved  as  a  picture 

file.  Prompts  for  the  name  of  the  picture  file.  If 
the  picture  file  does  not  exist,  a  default  picture  will 
be  loaded.  Entering  the  file  name  ALLPIC  will  display 
all  the  area  in  which  data  on  vegetation  and  roads  exist. 

ZOOM  Redraws  the  picture  on  a  different  scale.  The  200m 

factor  is  an  integer  between  2  and  16.  Enter  the  scale 
factor  and  position  the  cursor  at  the  new  map  center. 

DRAWGRID  Draws  the  grid  to  the  screen  according  to  the  size  defined 

for  the  grid  by  using  either  SETCOORD  or  MAPSIZE  (see 
reference  manual  paragraph  3b).  If  no  grid  has  been 
defined,  the  default  grid  is  drawn. 

SET  COLOUR  Select  new  drawing  color  for  all  new  entities  from  the 
color  bars  drawn  at  the  bottom  of  the  screen.  If  an 
entity  has  been  selected,  its  color  will  be  changed  when 
that  entity  is  deselected  or  no  longer  highlighted.  The 
color  of  all  other  entities  created  before  this  time 
remain  unchanged. 

CLEAR  FOREGO  Clear  foreground  (top  plane)  is  the  plane  in  which  the 
data  menus  display  data.  Data  are  not  destroyed; 
only  the  display  is  cleared. 

CLEAR  BACKGD  Clear  background  (middle  plane). 


r.  Input/output.  The  menu  Is  drawn  at  the  bottom  of  the  screen  when  this 
selection  Is  made.  It  is  used  to  read,  record,  and  print  data. 

SET  FILE  NO  Changes  the  direct  access  file  number  for  subsequent  read 
and  record.  Data  are  stored  In  files  called 
DATANAMEI.DAT.  At  #  enter  the  file  number  for  direct 
access  Input/output. 

READ  DATA  Reads  data  from  direct  access  file.  Data  are  stored  In 

files  called  DATANAMEI.DAT.  If  the  file  number  has  not 
been  set,  at  #,  enter  the  number  of  the  direct  access 
file.  Records  may  be  referenced  by  the  entity 
Identification  number  or  by  characters  in  the  entity  name. 
It  prompts  for  the  characters  to  search  for  (enter  *  for 
any  character).  If  no  characters  are  Input,  then  It 
prompts  for  the  Identification  number  of  the  first  and 
last  entity  to  be  read.  All  entitles  read  In  are  drawn  on 
the  screen.  Existing  entities  with  the  same 
Identification  numbers  are  overwritten. 

READ  VIC  FILE  Read  from  a  sequential  VIC  data  file  In  OUTPUT: 

DATANAMEI.OUT  and  record  data  In  a  direct  access  file 
DA_DATA:DATANAME#.DAT.  Enter  VIC  file  name  -.OUT 
Are  coords  In  military  coords?  Answer  YES/NO. 

If  reading  UTM,  enter  coords  of  the  VIC  origin. 

RECORD  DATA  Writes  data  to  direct  access  file.  Data  are  stored  In 
files  called  DATANAMEI.DAT.  If  the  file  number  has  not 
been  set,  enter  I,  the  number  of  the  direct  access  file. 
Records  may  be  referenced  by  the  entity  identification 
number,  or  by  characters  In  the  entity  name.  It  prompts 
for  the  characters  to  search  for  (enter  *  for  any 
character).  If  no  characters  are  Input,  It  prompts  for 
the  Identification  number  of  the  first  and  last  entity  to 
be  recorded.  Data  on  entitles  which  have  been  recorded 
are  deleted  and  the  entitles  are  removed  from  the  screen. 

PRINT  DATAMC  Prints  data  on  all  entitles.  Entitles  are  listed  In  the 
order  in  which  they  are  read  In.  Therefore,  if  blue  units 
are  required  before  red  units,  all  blue  units  should  be 
read  In  first.  Coordinates  are  printed  In  military 
coordinates  or  UTM  coords  depending  on  whether  the 
parameter  PRINT  UTM  is  switched  on  or  off.  Input  the 
output  file  number:  Enter  0  to  display  data  on  CRT 
I  (file  number)  to  produce  a  VIC  file  DATANAMEI.OUT. 

If  printing  In  UTM,  enter  the  X,Y  map  coords  of  the  VIC 
origin  to  produce  X,Y  coords  for  VIC  input. 

LIST  FILES  Lists  all  direct  access  files  from  DA  DATA:  on  the 

CRT,  which  are  associated  with  the  selected  data  type. 
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VIP  OUTPUT  FORMAT 

CONTENTS 


1.  Format 

a.  Barrier  file 

b.  Line  obstacle  file 

c.  Minefield  file 

d.  Network  file 

e.  Logistics  file 

f.  Tactical  area  file 

g.  Unit  file 

h.  Unit  subordinate  file 
1.  Communications  file 

2.  VIP  output  processing 

a.  General 

b.  Tactical 

c.  Route  planning 

d.  Network/logistics 
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1.  Output  format.  The  following  Is  the  header  Information  on  each  of  the 
files  contained  in  OUTPUT:.  All  coordinate  data  must  be  written  In  x.y 
coordinates  and  not  In  Military  coordinates  as  VIC  does  not  contain  a 
translator  for  these  coMputatlons.  Also,  the  NETWORK#. OUT  file  displays  node- 
to- node  distance  and  the  VIC  software  only  works  In  node- to- node  tines.  The 
necessary  tine  calculation  Is  perforned  within  VIP  and  Is  displayed  with  the 
logistic  data  file. 


a.  Barrier  file.  From  the  file  OUTPUT: BARRIER#. OUT 
1 1  AREA  OBSTACLE  DATA 

0  1 1  NUMBER  OF  BARRIERS 

"BARRIER  VISIBILITY  TRAFFIC ABILITY  BARRIER  NO  OF  COORDS 

1 '  NO  TYPE  POINTS 


b.  Line  obstacle  file.  Fron  the  file  OUTPUT :LINEOBSTCLE#. OUT 
LINE  OBSTACLE  DATA 


0  ' ‘  NUMBER  OF  OBSTACLE  PROTOTYPES 

0  ' ‘  NUMBER  OF  LINE  OBSTACLES 

0  * ‘  NUMBER  OF  LINE  SEGMENTS 


PROTOTYPE  BREACH  UNBREACHED  BREACHED 
NAME  TYPE  BLUE  RED  BLUE  REO 


•  f 


FEATURE  OBSTACLE  ENGINEER  OWNER  NUMBER 

NUMBER  PROTOTYPE  MISSION  SIDE  POINTS 


c.  Ml n« field  file.  Froei  the  file  OUTPUT:M I NEF I ELD#. OUT 
'  MINEFIELD  DATA 

0  ' '  NUMBER  OF  MINEFIELD  TYPES 

0  "  NUMBER  OF  MINEFIELDS 

'ENG  NR  MINE  TYPE  FRONT  OEPTH  ORIENT  LXATION 

'  X 

NO  OF  START  TIME 
MINES  DO  HH  MM 


d.  Network  file.  Fro«  the  file  OUTPUT : NETWORK# . OUT 
NETWORK  DATA 

0  "  NUMBER  NODES  IN  NETWORK 

‘NOOE  #  X  Y  CONNECTS  OIST 

LOGISTIC  NETWORK  DATA 


e.  Logistics  file.  Frow  the  file  OUTPUT: NETWORK#. OUT 
0  ' *  NUMBER  MOOES  IN  NETWORK 


NOOE  # 


TYPE  SUPPLY  ASSOC  #NOOE  PT  ALT  CONNECT 
NOOE  SERVICE  UNIT  QTY  LIST  TO 


ROAOWAY 

DESCRIPTION 


f.  Tactical  area  file.  From  the  file  OUTPUT :TACTAREA#. OUT 


TACTICAL  AREA  DATA 


0  * 1  MAXIMUM  TACTICAL  AREA  NUMBER 


'NR  #  VERTICES  X-COORD  Y-COORD 


g.  Unit  file.  From  the  file  OUTPUT: UN IT#. OUT 


UNIT  LXATION  AND  PATH  POINT  DATA 


0  ' *  NUMBER  OF  PROTOTYPES 

0  ' '  NUMBER  OF  UNITS 


'NR  NAME 


ENTRY  INIT  PROTO 

DD:HH:MM  MASS  TYPE 


UNIT  #  PATH 
ORIEN  POINTS 


POINT 

TYPE 


PREP  AREA 
POS  TYPE 


LOCATION  WAIT  WAIT  TIME 
X  Y  TYPE  DD  :HH  :MM 


h.  Unit  subordinate  file.  From  the  file  OUTPUT: UN IT#. OUT 


SUBORDINATE  STRUCTURE  DATA 


NUMBER  OF  PHASE  AND  COORDINATION  GROUPS 


UNIT  NAME 


#SUB  PHASE  GP  LEADING  ECH  COORD  GROUP 


B 


El 


El 
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1.  Communications  file.  From  the  file  OUTPUT: UN IT#. OUT 


NUMBER  OF  COMMUNICATIONS  NETS 


1  1 

NUMBER 

AVERAGE  # 

"  NET 

SYSTEMS 

SYSTEMS  CHANNELS 

TYPE 

POLAR 

"  NET  OWNER  TYPE 

ON  NET 

ON  NET  NODE/NET 

NET 

IZATION 

TIME 

ANTENNA 

SWITCH 

GAIN 

HEIGHT 

TRANSMITTER 

SYSTEM 

TRAN  REC 

TRAN  REC 

POWER 

FREQ 

COMMUNICATIONS  NETS 


2.  VIP  output  processing.  Due  to  the  fact  that  VIP  uses  the  same  array  space 
when  workl ng  on  each  of  the  data  menus,  the  procedure  to  turn  VIP  data  files 
Into  VIC  readable  files  Is  discussed  separately  at  this  time. 

a.  General.  The  unit  data  files  created  by  YIP  are  turned  Into  VIC 
readable  files  by  the  following  procedures: 

(1)  Entering  the  INPUT/OUTPUT  command  from  either  the  unit  menu  or 
the  path  point  menu. 


The 


(2)  Select  "PRINT  DATAMC".  You  are  prompted  for  a  file  number, 
file  UNIT#. OUT  Is  In  OUTPUT:  awaiting  processing  Into  VIC. 

The  same  procedure  Is  used  for  the  following  menu  data  files: 

(a)  Subordinate  menu.  Creates  the  file  OUTPUT: UN IT#. SUB 

(b)  Minefield  menu.  Creates  the  file  OUTPUT:MINEFIELD#.OUT 

(c)  Barrier  men;i.  Creates  the  file  OUTPUT: BARRIER#. OUT 

(d)  Line  Obstacle  menu.  Creates  the  file  OUTPUT:LINEOBSTCLE#.OUT 

b.  Tactical.  This  menu  has  no  INPUT/OUTPUT  selection.  The  file  Is 
created,  opened,  and  closed  when  you  enter  and  exit  the  tactical  menu.  To 
create  an  .OUT  file,  select  the  "PRINT  DATAMC"  area  and  enter  a  file  number. 

c.  Route  planning.  If  a  route  planning  .OUT  file  Is  required,  the 
following  safeguards  must  be  Implemented  to  avoid  data  loss.  Input/Output  Is 
still  the  same  but  It  also  creates  a  file  0UTPUT:UNIT#.0UT.  To  avoid 
overwriting  of  the  unit  file,  you  must  choose  a  different  file  number.  This 
same  provision  also  applies  to  the  DA  DATA:  directory  when  dealing  with  the 
route  planning  menu. 
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d.  Network/logistics.  Though  the  logistics  menu  uses  the  network  menu 
data  file,  the  output  generated  by  these  two  menus  are  completely  different. 
Extreme  care  must  be  taken  In  assigning  DIFFERENT  file  numbers  to  each. 

Failure  to  do  so  will  result  In  the  overwriting  of  the  previous  data  file. 

e.  Additional  Information.  VIC  cannot  accept  Input  In  military 
coordinates  though  VIP  can  produce  them.  Watch  the  use  of  parameter  toggle 
"PRINT  UTM"  in  the  main  menu.  Reading  a  VIC  file  back  to  the  DA  DATA: 
directory  could  create  a  problem  If  the  file  already  exists.  The  file  from 
OUTPUT:  does  not  simply  overwrite  the  file  In  DAJDATA:,  It  "ands"  the  two  files 
together  with  only  duplicate  entries  being  overwritten.  Files  (.OUT)  must  be 
run  through  a  separate  preprocessor  to  reduce  them  down  to  data— essentially 
stripping  the  header  Information  off  the  files. 


APPENDIX  C 


PROGRAM  STRUCTURE  REFERENCE 
CONTENTS 


1.  General 

2.  Logical  assignments 

3.  Program  linking 

4.  YIP  modules 


1.  General .  VIP  Is  an  Interactive  system  to  facilitate  the  building  of  Input 
files.  The  preprocessor  Is  menu  driven.  There  Is  a  menu  containing  a  list  of 
keywords  for  each  data  type.  Additional  keywords  may  be  Input  from  the  CRT. 
Files  may  be  built  for  the  following  data: 

a.  Unit  locations  and  path  points 

b.  Unit  subordinate  structure 

c.  Tactical  areas 

d.  Minefields 

e.  Barriers  (area  obstacles) 

f.  Line  obstacles 

g.  Logistics  networks 

The  following  documentation  Is  set  up  for  a  system  11/780  with  a  file  hierarchy 
that  was  set  up  by  the  programmer  team  doing  the  work  at  this  time.  The 
assigned  loglcals  and  call  files  are  not  set  In  stone  but  It  Is  recommended 
that  unless  outside  considerations  override,  these  remain  the  way  they  are 
because  they  are  time  tested  and  proven  to  be  accurate. 

2.  Logical  assignments.  Before  the  VIP  package  can  be  executed,  a  series  of 
files  nave  to  be  set  up,  assigned,  or  modified  so  the  host  system  can 
Initialize  correctly.  These  statements  are  In  a  command  file  labeled  OASG.COM. 
This  file  can  be  executed  alone  or  In  conjunction  with  the  OLINK.COM  or  the 
0RUN.C0M  dlcussed  In  the  next  section. 


The  0ASG.C0M  file  appears  as  follows: 

S  ASSIGN  DATASDUA2: [VIP. KELLNER]  0KGL 
$  ASSIGN  DBA0 : [GRAPHICS. RAMTEK. CGI P]  0RGL 

$  ASSIGN  DATA$0UA2:[VIP.DA  DATA]  0A  DATA 
S  ASSIGN  DATAJDUA2:[ VIP. OUTPUT]  OUTPUT 
$  ASSIGN  DATAJDUA2: [VIP. ROUTE]  ROUTEFILE 
S  ASSIGN  DATA$DUA2:[ VIP. SYMBOLS]  SYMBOLS 
%  ASSIGN  0ATASDUA2: [VIP. ROADS]  ROADS 

$  ASSIGN  DATA$DUA2:[ VIP. MAPS]  MAPFILE 
S  ASSIGN  DATA$DUA2:[VIP.PIC]  PICFILE 
$  ASSIGN  DATA$DUA2:[VIP.C0L0R]  COLFILE 
%  ASSIGN  DATA$OUA2:[VIP.MEN]  MENFILE 
S  ASSIGN  DATASDUA2 :[V1P.D0C]  VIPOOC 
S  ASSIGN  DATA$DUA2:[ VIP. COMMON]  VIPCMN 


!  KELLNER  GRAPHICS  SOFTWARE 
!  RAMTEK  GRAPHICS  SOFTWARE 

!  READ/WRITE  VIP  RA  FILES 
!  THE  .OUT  FILES  FROM  VIP 
!  THE  .ROT  FILES  FROM  VIP 
!  THE  SYMBOL  FILE 
t  LINDA’S  ROUTE  PLANNING 
!  INPUT  FILES 

!  MAP  FILES  . VEG, .NVG, .MAP 
!  PICTURE  FILES 
(  COLOR  FILES  .KOL  (13BIT) 

!  THE  MENU  FILES  .MMN..MEN 
!  LINDA'S  HELP  FILES  .DOC 
!  THE  COMMONS  .CMN, .PAR, .FMT 
!  .CDA  FILES 


3.  Program  linking.  The  OLINK.COM  file  takes  all  the  related  object  code 
files  and  creates  the  executable  code  file  necessary  for  VIP  to  run.  This 
allows  the  user  to  modify  portions  of  the  program  and  Implement  them  without 
destroying  the  Integrity  of  the  software  for  another  user.  As  stated  above, 
the  OASG.COM  file  can  be  part  of  the  OLINK.COM  file  as  follows. 

Listing  of  the  0LINK.C0M: 

$  0[VIP.CODE]OASG 
$  SET  DEF  DATA$DUA2:[VIP.CHENAULT] 

$  ill! 

$  LIB/EXTR«*/0UTP»FLVN.0BJ  [VIP.FLYN]A 
$  LIB/EXTR«*/0UTP«MIKES.0BJ  A 
$  ! ! ! ! 

$  LINK  [VIP.CHENAULT]ADRIVE  VIP,- 
FLVN. OBJ, MIKES. OBJ,- 
$  !!11 

[VIP.C00E1A/LIB,- 
$  1111 

0KGL:CGF/0PT 
$  EXIT 

As  stated  before,  any  modifications  In  execution  (In  this  case,  any  FLVN 
modifications  existing  In  [VIP. FLVN]  are  picked  up  and  linked  before  getting 
the  rest  of  the  code  (FLVN/WSMR  approved)  from  the  object  library  In 
[VIP. CODE].  This  link  creates  the  VIP  executable  file  ADRIYE_VIP.EXE.  This 
can  now  be  run  directly  or  as  part  of  a  0RUN.C0M  file.  If  It  Is  run 
directly,  the  proper  assign  statements  must  be  done  first.  These  statements 
are  part  of  the  ORUN.COM  file  but  do  change  from  system  to  system.  See  VIP 
support  for  further  Information. 

The  format  of  the  "0RUN.C0M"  Is  as  follows: 

$  SET  MESSAGE/N0FAC/N0I0ENT/N0TEXT/N0SEV  l  SO  SUPERCEDE  MSGS  DONT  APPEAR 
$  9[VIP.C0DE]0ASG  1  PICK  UP  VIP  LOGICALS 

$  SET  MESSAGE/FAC/ IDENT/TEXT/SEV 

I  RUN  iVIP.CH£NAULT]ADRIVE  VIP  !  EXECUTE  LO  RES  VIP 

$  EXIT 

As  with  the  OLINK  file,  the  OASG.COM  Is  Included  In  the  ORUN.COM  file. 

This  eliminates  the  necessity  of  doing  a  OASG  or  a  OLINK  each  terminal 
session,  provided  you  use  the  same  executable  file. 


I  PICK  UP  VIP  LOGICALS 
1  GO  TO  YOUR  LOCAL  DIRECTORY 

I  FLVN  VIP  CHANGES 
1  INDIVIDUALS  VIP  CHANGES 

!  LINK  MAIN  DRIVER 
1  WITH  ANY  CHANGED  ROUTINES 

1  AND  ALL  UNCHANGED  CODE 

1  TO  PROPER  GRAPHIC  PACKAGE 


4.  VIP  modules.  The  VIP  software  package  is  broken  down  into  several 
different  modules.  These  modules  being: 

a.  ADRIVE  VIP  Main  driver.  Driven  by  variable  KEY  (12-character  text 
variable)  whlcK  Is  input  from  the  menu  or  the  CRT  depending  on  whether  the 
variable  SELECT  *  MENU  or  KEYWORD. 

b.  ADR1YE_KEYW0RDS_  Determine  the  action  resulting  from  the  selection  of 
KEY.  Each  menu  has  a  subroutine  associated  with  it  which  lists  its  keywords. 
Keywords  input  from  the  CRT  are  dealt  with  in  ADRIVE  KEYWORDS  CRT  and  in 
MDRIVE. 


c.  ENTITY_  General  routines  which  deal  with  operations  on  all  types  of 
entities.  An  entity  may  be: 

(1)  Tactical  area 

(2)  Unit  initial  location  +  path  points 

(3)  Minefield 

(4)  Barrier 

(5)  Line  obstacle 

d.  10  Input/output  routines  for  direct  access  files,  sequential  files, 
and  for  prTntlng  Information  to  the  CRT  or  the  RAMTEK. 

e.  NET_  Network  routines  for  logistics. 

f.  R0AD_NET_  Accesses  the  link  node  data  base  for  road  networks. 

g.  R0AD_PATH_  Use  the  link  node  data  base  to  construct  paths  along  the 
roads. 

h.  SUBMENU_  Draw  and  select  from  the  submenus. 

1.  TAC_  Tactical  area  routines. 

j.  UNIT_ROUTE_  Constructs  detailed  paths  between  VIC  path  points. 

k.  UNIT_SUBORD_  Constructs  the  unit  subordinate  structure. 

l.  UTLY  Utility  routines. 
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